home *** CD-ROM | disk | FTP | other *** search
/ Celestin Apprentice 5 / Apprentice-Release5.iso / Source Code / PowerPlant / LPasswordField 1.0a / LPasswordField ReadMe next >
Encoding:
Text File  |  1996-05-05  |  1.5 KB  |  22 lines  |  [TEXT/ttxt]

  1. LPasswordField.cp
  2. Dair Grant, dair@kagi.com, http://www.kagi.com/authors/dair
  3.  
  4. An LPasswordField is Pane containing editable text, which only displays bullet characters.
  5.  
  6. Use an LPasswordField for small amounts of monstyled text, such as a text entry field in a dialog box. PasswordField derives from the LEditField class, so similar restrictions apply to its usage (it uses TextEdit, and it's not a View, so you can't put a PasswordField in a Scroller).
  7.  
  8. PasswordFields should behave exactly like EditFields, the only difference being that characters are always displayed as bullets. You use the same routines (SetDescriptor/GetDescriptor and SetValue/ GetValue) to manipulate the text, and the same commands can be performed on it (cut, copy, paste, etc). The PasswordField takes care of ensuring that only bullets are ever displayed.
  9.  
  10. The bullet character defaults to ‘•’. The SetBullet method allows this to be changed.
  11.  
  12. To use a PasswordField, create and position an EditField with Constructor, and set the class ID to ‘pass’ once you're happy with it. Then include LPasswordField.h in the relevent source files, add LPasswordField.cp to your project, and put the line
  13.  
  14. URegistrar::RegisterClass(LPasswordField::class_ID, LPasswordField::CreatePasswordFieldStream);
  15.  
  16. in your application's constructor.
  17.  
  18. You may use the LPasswordField class in any project you write, without restriction. Comments, bugs, or suggestions are more than welcome - send them to dair@kagi.com.
  19.  
  20.  
  21. -dair
  22. 5th May, 1996